﻿using System;

namespace WayApplication
{
    /*
     一个方法是把一些相关的语句组织在一起，用来执行一个任务的语句块。每一个 C# 程序至少有一个带有 Main 方法的类。
     要使用一个方法，您需要：
        定义方法
        调用方法
     */
    class DescWay
    {
        /*
         当定义一个方法时，从根本上说是在声明它的结构元素
         语法:
            <Access Specofoer> <Return Type> <Method Name>(Parammter List)
            {
                Method Body
            }
         元素:
            Access Specifier: 访问修饰符，这个决定了变量或方法对于另一个类的可见性
            Return type: 返回类型，一个方法可以返回一个值。返回类型是方法返回的值的数据类型。如果方法不返回任何值
                        则返回类型为 void
            Method name: 方法名称，是一个唯一的标识符，且是大小写敏感的。它不能与类中声明的其他标识符相同。
            Parameter list: 参数列表，使用圆括号括起来，该参数是用来传递和接收方法的数据。参数列表是指方法的参数类型、
                            顺序、数量。参数是可选的，也就是说，一个方法可能不包含参数
            Method body: 方法主体，包含了完成任务所需的指令集。
         */
        public int FindMax(int num1, int num2)
        {
            int result;

            if (num1 > num2)
                result = num1;
            else
                result = num2;
            return result;
        }

        static void callWay()
        {
            // 调用方法
            int a = 100;
            int b = 200;
            int ret;
            
            DescWay ds = new DescWay();
            ret = ds.FindMax(a, b);
            Console.WriteLine("最大值是: {0}", ret);
            Console.ReadLine();
        }
    }

    class CallWayByOtherClass
    { 
        static void callWay()
        {
            int a = 100;
            int b = 200;
            int ret;
            DescWay ds = new();
            ret = ds.FindMax(a, b);
            Console.WriteLine("最大值是: {0}", ret);
            Console.ReadLine();
        }
    }

    /* 一个方法可以自我调用。这就是所谓的 递归。*/
    class NumberManipulator1
    {
        public int factorial(int num)
        {
            if (num == 1)
            {
                return 1;
            }
            else
            {
                return num * factorial(num - 1);
            }
        }
    }

    /*
     当调用带有参数的方法时，您需要向方法传递参数。在 C# 中，有三种向方法传递参数的方式：
     值参数        	这种方式复制参数的实际值给函数的形式参数，实参和形参使用的是两个不同内存中的值。
                    在这种情况下，当形参的值发生改变时，不会影响实参的值，从而保证了实参数据的安全。
     引用参数       这种方式复制参数的内存位置的引用给形式参数。这意味着，当形参的值发生改变时，同时也改变实参的值。
     输出参数       这种方式可以返回多个值。
     */

    /*
     按值传递参数
     这是参数传递的默认方式。在这种方式下，当调用一个方法时，会为每个值参数创建一个新的存储位置。
     实际参数的值会复制给形参，实参和形参使用的是两个不同内存中的值。
     所以，当形参的值发生改变时，不会影响实参的值，从而保证了实参数据的安全
     */
    class NUmberManipulator2
    {
        public void swap(int x, int y)
        {
            int temp;

            temp = x;
            x = y;
            y = temp;
        }

        static void swapTest1()
        {
            NUmberManipulator2 nr2 = new();
            int a = 100;
            int b = 200;

            Console.WriteLine("在交换之前, a的值: {0}", a);
            Console.WriteLine("在交换之前, b的值: {0}", b);

            nr2.swap(a, b);

            Console.WriteLine("在交换之后, a的值: {0}", a);
            Console.WriteLine("在交换之后, b的值: {0}", b);

            Console.ReadLine();
        }
    }

    /*
     按引用传递参数
     引用参数是一个对变量的内存位置的引用。当按引用传递参数时，与值参数不同的是，它不会为这些参数创建一个新的存储位置。
     引用参数表示与提供给方法的实际参数具有相同的内存位置。
     */
    class NumberManipulator3
    {
        public void swap(ref int x, ref int y)
        {
            int temp;

            temp = x;
            x = y;
            y = temp;
        }

        public static void swapTest1()
        {
            NumberManipulator3 nr = new();

            int a = 100;
            int b = 200;

            Console.WriteLine("在交换之前, a的值: {0}", a);
            Console.WriteLine("在交换之前, b的值: {0}", b);

            nr.swap(ref a, ref b);

            Console.WriteLine("在交换之后, a的值: {0}", a);
            Console.WriteLine("在交换之后, b的值: {0}", b);

            Console.ReadLine();
        }
    }

    /*
     按输出传递参数
     return 语句可用于只从函数中返回一个值。
     但是，可以使用 输出参数 来从函数中返回两个值。输出参数会把方法输出的数据赋给自己，其他方面与引用参数相似。
     提供给输出参数的变量不需要赋值。当需要从一个参数没有指定初始值的方法中返回值时，输出参数特别有用。
     */
    class NumberManipulator4
    {
        public void getValue(out int x)
        {
            int temp = 5;
            x = temp;
        }

        public void getValues(out int x, out int y)
        {
            Console.WriteLine("请输入第一个值: ");
            x = Convert.ToInt32(Console.ReadLine());
            Console.WriteLine("请输入第二个值: ");
            y = Convert.ToInt32(Console.ReadLine());
        }

        public static void getValueTest1()
        {
            NumberManipulator4 nr = new();

            int a = 100;

            Console.WriteLine("在方法调用之前: a 的值: {0}", a);

            nr.getValue(out a);

            Console.WriteLine("在方法调用之后: a 的值: {0}", a);
            Console.ReadLine();
        }

        public static void getValuesTest1()
        {
            NumberManipulator4 nr = new();

            int a, b;

            nr.getValues(out a, out b);

            Console.WriteLine("在方法调用之后, a 的值: {0}", a);
            Console.WriteLine("在方法调用之后, b 的值: {0}", b);
            Console.ReadLine();
        }
    }
}